home *** CD-ROM | disk | FTP | other *** search
/ Aminet 38 / Aminet 38 (2000)(Schatztruhe)[!][Aug 2000].iso / Aminet / dev / e / EasyGUI_OS12.readme < prev    next >
Encoding:
Text File  |  2000-07-01  |  14.1 KB  |  293 lines
  1. Short:    V3.3b4 EasyGUI with OS 1.2+ support V0.9
  2. Author:   Ralf "hippie2000" Steines + Various (see below)
  3. Uploader: metamonk@yahoo.com
  4. Type:     dev/e
  5. Requires: gadtools13.library, AmigaOS 1.2 or higher
  6.  
  7.  
  8. INTRODUCTION
  9. ------------
  10.  
  11.   EasyGUI_OS12 is a fully compatible version of EasyGUI V3.3b4, which
  12.   was enhanced to work under any versions of the Amiga-OS which are
  13.   supported by Amiga-E (V1.2+/V33+) (original EasyGUI requires V37)
  14.  
  15.   All pre V36 OS support functions were written in hybrid way, so that
  16.   on newer Amiga-OS everything is done the same way as in the original
  17.   EasyGUI, which is a very future compatible solution IMHO.
  18.  
  19.   Programs using the EasyGUI_OS12 modules do not have any additional
  20.   requirements unless they are run on pre V36 Amiga-OS, in which case
  21.   they require the "gadtools13.library" V34.23 by JABA development,
  22.   which is not part of this package, since I do neither know about the
  23.   legal state of that library, nor do I know how to contact the author
  24.   yet (HELP ME PLEASE!!!) Check your libs: directory or the stonecracker
  25.   archive from aminet or visit amigasystems.org to find this lib.
  26.  
  27.  
  28. COPYRIGHT
  29. ---------
  30.  
  31.   Note that this is an "unofficial" release of EasyGUI, released with
  32.   permission of Jason R. Hulance (current maintainer of EasyGUI).
  33.  
  34.   The EasyGUI module, the EasyGUI example sources and docs are
  35.   Copyright (c) 1994-6, Wouter van Oortmerssen (the author of the great
  36.   language E) and Jason R. Hulance (the author of the "beginners.guide"
  37.   and long time supporter of E).
  38.  
  39.   The plugins, demo sources and docs in the EasyPlugins folders are
  40.   (C) Copyright Ali Graham, Fabio Rotondo and Ralph Wermke, used with
  41.   permission too. See the headers of each source file to find out who
  42.   exactly did what.
  43.  
  44.   All changes and additional files are Copyright (c) 2000,
  45.   Ralf 'hippie2000' Steines [metamonk@yahoo.com] and inherit the legal
  46.   state from the original EasyGUI disctribution. (Reuse there is welcome :)
  47.  
  48.   Please do not redistribute any modified versions of these files
  49.   without having talked about first, since this is going to be updated
  50.   again (hopefully :)
  51.  
  52.  
  53. PROGRAMMERS INFO
  54. ----------------
  55.  
  56.   EasyGUI_OS12 is used in the same way as the original EasyGUI, so read
  57.   the original manual which you can find in the docs/easygui#? folder.
  58.   Additionally to all info provided there you need to know a few
  59.   differences:
  60.  
  61.   - The workbenchbase shared by EasyGUI_OS12 will be NIL if the
  62.     workbench.library could not be opened (which is the fact on older
  63.     Amiga-OS) WITHOUT raising an exception. So, if you use AppIcon/
  64.     AppTool/AppWindow functions test workbenchbase first and degrade
  65.     graceful if it is NIL. The EasyGUI_OS12 builtin AppWindow support
  66.     is already safe.
  67.  
  68.   - Write hybrid code if you use new os functions, and do not rely on
  69.     KickVersion() only (which just checks the exec library version).
  70.     For this the  module 'hybrid/version' is provided with this package,
  71.     making life easier for you:
  72.  
  73.       bool:=intuiVersion(minver)        -> intuitionbase version
  74.       bool:=gfxVersion(minver)          -> gfxbase version
  75.       bool:=libVersion(libbase,minver)  -> whateverbase version
  76.  
  77.   - Take care that plugins you use also were compiled with EasyGUI_OS12
  78.     otherwise both versions of EasyGUI will be included in your project.
  79.     (check the example plugins how to do that best)
  80.  
  81.   - When writing plugins you will very likely need the taglist parsing
  82.     function GetTagData() of utility.library. Since this library does
  83.     not exist on older Amiga-OS versions you should use the hybrid
  84.     replacement in the module 'hybrid/tagdata' instead, which uses the
  85.     utility function in case of a non zero utilitybase, otherwise a
  86.     replacement. The module 'hybrid/utility' provides you with the
  87.     necessary open and close functions which do not raise an exception.
  88.  
  89.       openUtility()   -> at the beginning of the main prog
  90.                          (no return code, result is utilitybase)
  91.       data:=getTagData(tag,default,taglist) -> within the plugin
  92.       closeUtility()  -> at the end of the  main prog
  93.  
  94.   - Note that old intuition was not very resistant against passing it
  95.     stupid values, so don't blame me or the authors of EasyGUI for
  96.     possible GURUs. During tests i made excellent experience with
  97.     gadtools13.library under WB1.2 and 1.3, and i did not experience
  98.     any GURU which was not my fault :)
  99.  
  100.     DANGER: the EasyGUI functions movewin() and sizewin() horribly
  101.     crash on early intuition versions when the window is moved out
  102.     of the screen. In the next release i should implement some
  103.     clipping to avoid this.
  104.  
  105.   - Using changing GUIs under early intuition versions requires some
  106.     care during design. Best: don't use. Second best: try to make the
  107.     size of all GUIs the same, and try to open the biggest one first.
  108.     The changegui feature relies on window resizing (which is not
  109.     guaranteed to happen ever) and may by this lead to dangerous
  110.     gadget sizes. Modern intuition is flexible in such cases, but
  111.     early intuition verions prefer to crash in such situations.
  112.  
  113.  
  114. GADTOOLS VERSIONS
  115. -----------------
  116.  
  117.   Note that gadtools13.library and even early real gadtools versions
  118.   misses some functions which are present in newer ones. This should
  119.   not be a big problem since all important things work. Just don't rely
  120.   on the behaviour of recent gadtools and your software will work fine.
  121.  
  122.   Here a reference of things I noticed, sorted by gadget kind:
  123.  
  124.  
  125.       BUTTON,SBUTTON    GT13  -
  126.                         GT37  -
  127.  
  128.       CHECK             GT13  -
  129.                         GT37  -
  130.  
  131.       MX                Do not use disabling, really makes no sense:
  132.                         GT13  only disables + ghosts the first item.
  133.                               resize breaks disabling.
  134.                               Text is spaced but not rendered.
  135.                         GT37  disabling visibly sets to first item
  136.                               of the list, value is not affected.
  137.                               Resize restores the visible state.
  138.                               The left or right text is spaced but
  139.                               is not rendered.
  140.  
  141.       CYCLE             GT13  set or resize breaks disabling
  142.                         GT37  -
  143.  
  144.       INTEGER,STR       GT13  -
  145.                         GT37  -
  146.  
  147.       NUM,TEXT          Do not use disabling, really makes no sense:
  148.                         GT13  can be disabled, but disabling breaks
  149.                               by set or resize and is NOT possible
  150.                               with any later GT versions at all!!!
  151.                         GT37  No disable possible. This is no bug but
  152.                               a feature. Maybe EasyGUI should not
  153.                               allow disabling of these gadgets at all.
  154.  
  155.       SLIDE             Do not use without a slider value format text!
  156.                         GT13  always clears the background behind
  157.                               slider values, even with an empty format
  158.                               string. Sliders values are still a TODO
  159.                               in EasyGUI so no workaround was added.
  160.                         GT37  Rendering errors after a set within a
  161.                               disabled gadget, old knob position is
  162.                               cleared and remains unghosted.
  163.  
  164.       SCROLL            GT13  -
  165.                         GT37  Rendering errors after a set within a
  166.                               disabled gadget, old knob position is
  167.                               cleared and remains unghosted.
  168.  
  169.       LISTV             Do not rely on the read only feature, use a
  170.                         "do nothing" action funtion additionally.
  171.                         GT13  set or resize breaks disabling, read
  172.                               only (recessed) mode does not exist.
  173.                               always read/write.
  174.                         GT37  Listviews can't be disabled
  175.  
  176.       PALETTE           GT13  set breaks disabling, setting to
  177.                               a value above the screen's depth is
  178.                               not visible (but works internally)
  179.                         GT37  setting to a value above the screen's
  180.                               depth is not visible (but works
  181.                               internally)
  182.  
  183.       BEVEL,BEVELR      GT13  no recessed bevel, both render same.
  184.                         GT37  -
  185.  
  186.  
  187.   GT13 means gadtools13.library, GT37 means gadtools.library V37...
  188.  
  189.   I had no access to a V36 ROM so far (or is GT36 disk based?),
  190.   so i could not test this gadtools version.
  191.  
  192.  
  193. ============================= Archive contents =============================
  194.  
  195. Original  Packed Ratio    Date     Time    Name
  196. -------- ------- ----- --------- --------  -------------
  197.    62268   23100 62.9% 09-Jun-97 18:14:24 +EasyGUI.doc
  198.     1568     732 53.3% 04-Dec-96 23:16:08 +password.doc
  199.      514     295 42.6% 13-Feb-97 18:44:12 +ticker.doc
  200.     8647    3339 61.3% 11-Jun-00 18:42:28 +EasyGUI_OS12.doc
  201.     2338     977 58.2% 25-May-98 04:40:32 +bar.guide
  202.     4590    1692 63.1% 22-Feb-98 23:05:58 +corners.guide
  203.     5541    2326 58.0% 11-Mar-98 17:00:48 +dclistview.doc
  204.     5543    1722 68.9% 29-Jan-98 21:40:52 +iconbox.guide
  205.     2028     833 58.9% 08-Feb-98 14:54:36 +icongad.guide
  206.     1683     676 59.8% 14-Feb-98 00:07:36 +location.guide
  207.     6620    2239 66.1% 25-May-98 04:32:40 +multitext.guide
  208.     5367    1916 64.3% 20-Feb-98 00:18:42 +popmisc.guide
  209.     4437    1404 68.3% 05-Oct-97 14:35:00 +rawkey.guide
  210.     5466    1903 65.1% 15-Nov-97 15:09:32 +simplegauge.guide
  211.     2260     916 59.4% 25-May-98 04:35:22 +space.guide
  212.     5030    1779 64.6% 13-Mar-98 23:15:40 +toolbar.guide
  213.     3398    1294 61.9% 11-Jan-98 13:28:20 +xygadget.guide
  214.     7491    2242 70.0% 11-Jun-00 18:41:46 +history.doc
  215.    72076   22065 69.3% 11-Jun-00 18:09:22 +test_os12
  216.    62524   10727 82.8% 11-Jun-00 18:03:30 +test_os12.e
  217.    10291    2564 75.0% 06-Jun-00 02:07:14 +all_os12.e
  218.     1059     505 52.3% 07-Jun-00 03:53:12 +password_test_os12.e
  219.     1792     862 51.8% 06-Jun-00 02:21:24 +testaw_os12.e
  220.     1052     511 51.4% 06-Jun-00 02:22:32 +testchange_os12.e
  221.     8231    2559 68.9% 06-Jun-00 02:23:22 +testchange_os12_2.e
  222.     2969    1105 62.7% 06-Jun-00 02:24:32 +testkey_os12.e
  223.     2090     992 52.5% 06-Jun-00 02:25:08 +testmulti_os12.e
  224.     1667     769 53.8% 06-Jun-00 02:25:44 +testmulti_os12_2.e
  225.      584     363 37.8% 06-Jun-00 02:26:30 +testqual_os12.e
  226.      532     316 40.6% 07-Jun-00 03:54:36 +ticker_test_os12.e
  227.      720     393 45.4% 06-Jun-00 02:27:46 +windowify_test_os12.e
  228.     2698     744 72.4% 06-Jun-00 14:37:28 +bar_os12_demo.e
  229.     3169     782 75.3% 06-Jun-00 14:20:08 +corners_os12_demo.e
  230.     2223     922 58.5% 06-Jun-00 14:37:58 +dclistview_os12_demo1.e
  231.     1865     654 64.9% 06-Jun-00 14:23:36 +iconbox_os12_demo.e
  232.     1036     511 50.6% 06-Jun-00 11:45:20 +icongad_os12_demo.e
  233.      994     401 59.6% 06-Jun-00 11:46:28 +location_os12_demo.e
  234.     3080     909 70.4% 06-Jun-00 14:26:26 +multitext_os12_demo.e
  235.     2310     604 73.8% 06-Jun-00 14:28:04 +popmisc_os12_demo.e
  236.      939     503 46.4% 06-Jun-00 14:29:30 +rawkey_os12_demo.e
  237.     3481    1082 68.9% 06-Jun-00 12:12:26 +simplegauge_os12_demo.e
  238.     2794     609 78.2% 06-Jun-00 14:33:28 +space_os12_demo.e
  239.     3346     852 74.5% 06-Jun-00 14:34:20 +toolbar_os12_demo.e
  240.     2072     669 67.7% 06-Jun-00 14:36:20 +xygadget_os12_demo.e
  241.     1628     782 51.9% 11-Jun-00 18:09:26 +bar_os12.m
  242.     4126    1586 61.5% 11-Jun-00 18:09:26 +corners_os12.m
  243.     3838    1718 55.2% 11-Jun-00 18:09:26 +dclistview_os12.m
  244.     2500    1125 55.0% 11-Jun-00 18:09:28 +iconbox_os12.m
  245.     1812     908 49.8% 11-Jun-00 18:09:28 +icongad_os12.m
  246.      796     446 43.9% 11-Jun-00 18:09:28 +location_os12.m
  247.     3958    1584 59.9% 11-Jun-00 18:09:30 +multitext_os12.m
  248.     5714    2347 58.9% 11-Jun-00 18:09:30 +popmisc_os12.m
  249.     2670    1014 62.0% 11-Jun-00 18:09:30 +rawkey_os12.m
  250.     4196    1733 58.6% 11-Jun-00 18:09:32 +simplegauge_os12.m
  251.      876     475 45.7% 11-Jun-00 18:09:32 +space_os12.m
  252.     4146    1527 63.1% 11-Jun-00 18:09:34 +toolbar_os12.m
  253.     1600     785 50.9% 11-Jun-00 18:09:34 +xygadget_os12.m
  254.      746     412 44.7% 11-Jun-00 18:09:18 +drawinfo.m
  255.      788     418 46.9% 11-Jun-00 18:09:18 +openwin.m
  256.      338     222 34.3% 11-Jun-00 18:09:18 +ports.m
  257.      476     301 36.7% 11-Jun-00 18:09:18 +strcmp.m
  258.      298     228 23.4% 11-Jun-00 18:09:18 +tagdata.m
  259.      220     154 30.0% 11-Jun-00 18:09:18 +utility.m
  260.      230     151 34.3% 11-Jun-00 18:09:18 +version.m
  261.     2760    1317 52.2% 11-Jun-00 18:09:22 +password_os12.m
  262.      534     328 38.5% 11-Jun-00 18:09:22 +ticker_os12.m
  263.     2168    1000 53.8% 11-Jun-00 18:09:22 +windowify_os12.m
  264.      716     313 56.2% 11-Jun-00 18:09:20 +easygui_notag_os12.m
  265.    31882   11724 63.2% 11-Jun-00 18:09:20 +easygui_os12.m
  266.     2620     963 63.2% 11-Jun-00 18:57:06 +bar_os12.e
  267.     8765    1967 77.5% 11-Jun-00 18:57:08 +corners_os12.e
  268.     5887    1887 67.9% 11-Jun-00 18:57:08 +dclistview_os12.e
  269.     4729    1429 69.7% 11-Jun-00 18:57:08 +iconbox_os12.e
  270.     4368    1828 58.1% 11-Jun-00 18:57:08 +icongad_os12.e
  271.     1220     548 55.0% 11-Jun-00 18:57:08 +location_os12.e
  272.     9187    2138 76.7% 11-Jun-00 18:57:08 +multitext_os12.e
  273.    12815    3066 76.0% 11-Jun-00 18:57:08 +popmisc_os12.e
  274.     4201    1221 70.9% 11-Jun-00 18:57:08 +rawkey_os12.e
  275.     8186    2591 68.3% 11-Jun-00 18:57:08 +simplegauge_os12.e
  276.     1543     676 56.1% 11-Jun-00 18:57:08 +space_os12.e
  277.     8827    2140 75.7% 11-Jun-00 18:57:08 +toolbar_os12.e
  278.     3256    1177 63.8% 11-Jun-00 18:57:08 +xygadget_os12.e
  279.     1855     831 55.2% 11-Jun-00 18:57:08 +drawinfo.e
  280.     1735     758 56.3% 11-Jun-00 18:57:08 +openwin.e
  281.      800     457 42.8% 11-Jun-00 18:57:08 +ports.e
  282.      986     516 47.6% 11-Jun-00 18:57:08 +strcmp.e
  283.      972     552 43.2% 11-Jun-00 18:57:08 +tagdata.e
  284.      722     428 40.7% 11-Jun-00 18:57:08 +utility.e
  285.      794     450 43.3% 11-Jun-00 18:57:08 +version.e
  286.     4013    1594 60.2% 11-Jun-00 18:57:08 +password_os12.e
  287.      595     328 44.8% 11-Jun-00 18:57:08 +ticker_os12.e
  288.     2367     979 58.6% 11-Jun-00 18:57:08 +windowify_os12.e
  289.     1039     342 67.0% 11-Jun-00 18:57:08 +easygui_notag_os12.e
  290.    63709   20323 68.1% 11-Jun-00 18:57:08 +easygui_os12.e
  291. -------- ------- ----- --------- --------
  292.   564590  184145 67.3% 12-Jun-100 16:15:40   94 files
  293.